ОбъектXDTO.Добавить (XDTODataObject.Add)
ОбъектXDTO (XDTODataObject)
Добавить (Add)
Доступен, начиная с версии 8.1.
Вариант синтаксиса: Установка значения нового произвольного свойства
Синтаксис:
Добавить(<Форма>, <URIПространстваИмен>, <ЛокальноеИмя>, <ЭлементДанных>, <НазначениеТипа>)Параметры:
<Форма> (обязательный)
Форма XML представления произвольного свойства.
Может принимать значения Элемент или Атрибут.
<URIПространстваИмен> (обязательный)
URI пространства имен XML представления произвольного свойства.
<ЛокальноеИмя> (обязательный)
Локальное имя произвольного свойства.
<ЭлементДанных> (обязательный)
Элемент данных XDTO (значение или объект), являющийся значением произвольного свойства.
<НазначениеТипа> (необязательный)
Назначение типа данных произвольного свойства при сериализации.
Значение по умолчанию: Неявное.
Описание варианта метода:
Имя свойства будет создано автоматически, на основе локального имени XML представления свойства.В случае, если произвольное свойство с полученным именем уже существует и если предыдущая установка значения произвольного свойства выполнялась для данного произвольного свойства, либо другого свойства в случае наличия последовательности, свойство становится списковым с неограниченной верхней границей.
В противном случае будет инициировано исключение.
Тип создаваемого свойства всегда устанавливается anyType пространства имен схемы XML.
Вариант синтаксиса: Установка значения существующего произвольного свойства
Синтаксис:
Добавить(<Имя>, <ЭлементДанных>, <НазначениеТипа>)Параметры:
<Имя> (обязательный)
Имя произвольного свойства.
<ЭлементДанных> (обязательный)
Элемент данных XDTO (значение или объект), являющийся значением произвольного свойства.
<НазначениеТипа> (необязательный)
Назначение типа данных произвольного свойства при сериализации.
Значение по умолчанию: Неявное.
Описание варианта метода:
Если свойства с указанным именем не существует, то будет инициировано исключение.Если предыдущая установка значения произвольного свойства выполнялась для данного произвольного свойства, либо другого свойства в случае наличия последовательности, - свойство становится списковым с неограниченной верхней границей.
В противном случае будет инициировано исключение.
Описание:
Добавляет значение произвольного свойства.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Вызов метода может быть осуществлен только для объектов типов с установленным свойством Открытый, в противном случае будет инициировано исключение.Использование в версии:
Доступен, начиная с версии 8.1.
Описание изменено в версии 8.3.25.